home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / nslookup.man < prev    next >
Encoding:
Text File  |  1989-07-24  |  10.7 KB  |  331 lines
  1.  
  2.  
  3.  
  4. NSLOOKUP                  User Commands                  NSLOOKUP
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      nslookup - query name servers interactively
  10.  
  11. SSYYNNOOPPSSIISS
  12.      nnssllooookkuupp [ -_o_p_t_i_o_n ... ] [ _h_o_s_t-_t_o-_f_i_n_d | - [ _s_e_r_v_e_r ]]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      _N_s_l_o_o_k_u_p is a program to query DARPA Internet domain name
  16.      servers. Nslookup has two modes: interactive and non-
  17.      interactive.  Interactive mode allows the user to query the
  18.      name server for information about various  hosts and domains
  19.      or print a list of hosts in the domain. Non-interactive mode
  20.      is used to print just the name and Internet address of a
  21.      host or domain.
  22.  
  23.  
  24. AARRGGUUMMEENNTTSS
  25.      Interactive mode is entered in the following cases:
  26.  
  27.      a)  when no arguments are given (the default name server
  28.          will be used),
  29.  
  30.      b)  when the first argument is a hyphen (-) and the second
  31.          argument is the hostname or Internet address of a name
  32.          server.
  33.  
  34.      Non-interactive mode is used when the name of the host to be
  35.      looked up is given as the first argument. The optional
  36.      second argument specifies the hostname or Internet address
  37.      of a name server.
  38.  
  39.      The options listed under the ``set'' command below can be
  40.      specified on the command line if they precede the arguments
  41.      and are prefixed with a hyphen. For example, to change the
  42.      default query type to host information, and the default
  43.      timeout to 10 seconds, type:
  44.  
  45.           nslookup -query=hinfo -timeout=10
  46.  
  47.  
  48. IINNTTEERRAACCTTIIVVEE CCOOMMMMAANNDDSS
  49.      Commands may be interrupted at any time by typing a
  50.      control-C.  To exit, type a control-D (EOF) or type exit.
  51.      The command line length must be less than 80 characters.
  52.      NN..BB.. an unrecognized command will be interpreted as a host
  53.      name.
  54.  
  55.  
  56.      _h_o_s_t [_s_e_r_v_e_r]
  57.           Look up information for _h_o_s_t using the current default
  58.           server or using _s_e_r_v_e_r if specified.
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0              August 17, 1988                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NSLOOKUP                  User Commands                  NSLOOKUP
  71.  
  72.  
  73.  
  74.      sseerrvveerr _d_o_m_a_i_n
  75.      llsseerrvveerr _d_o_m_a_i_n
  76.           Change the default server to _d_o_m_a_i_n. LLsseerrvveerr uses the
  77.           initial server to look up information about _d_o_m_a_i_n
  78.           while sseerrvveerr uses the current default server. If an
  79.           authoritative answer can't be found, the names of
  80.           servers that might have the answer are returned.
  81.  
  82.  
  83.      rroooott Changes the default server to the server for the root
  84.           of the domain name space.  Currently, the host sri-
  85.           nic.arpa is used.  (This command is a synonym for the
  86.           llsseerrvveerr ssrrii--nniicc..aarrppaa.) The name of the root server can
  87.           be changed with the sseett rroooott command.
  88.  
  89.  
  90.      ffiinnggeerr [_n_a_m_e] [>> _f_i_l_e_n_a_m_e]
  91.      ffiinnggeerr [_n_a_m_e] [>>>> _f_i_l_e_n_a_m_e]
  92.           Connects with the finger server on the current host.
  93.           The current host is defined when a previous lookup for
  94.           a host was successful and returned address information
  95.           (see the sseett qquueerryyttyyppee==AA command).  _N_a_m_e is optional. >>
  96.           and >>>> can be used to redirect output in the usual
  97.           manner.
  98.  
  99.  
  100.      llss _d_o_m_a_i_n [>> _f_i_l_e_n_a_m_e]
  101.      llss _d_o_m_a_i_n [>>>> _f_i_l_e_n_a_m_e]
  102.      llss --aa _d_o_m_a_i_n [>> _f_i_l_e_n_a_m_e]
  103.      llss --aa _d_o_m_a_i_n [>>>> _f_i_l_e_n_a_m_e]
  104.      llss --hh _d_o_m_a_i_n [>> _f_i_l_e_n_a_m_e]
  105.      llss --hh _d_o_m_a_i_n [>>>> _f_i_l_e_n_a_m_e]
  106.      llss --dd _d_o_m_a_i_n [>> _f_i_l_e_n_a_m_e]
  107.      llss --dd _d_o_m_a_i_n [>>>> _f_i_l_e_n_a_m_e]
  108.           List the information available for _d_o_m_a_i_n, optionally
  109.           creating or appending to _f_i_l_e_n_a_m_e.  The default output
  110.           contains host names and their Internet addresses. The
  111.           --aa option lists aliases of hosts in the domain.  The --hh
  112.           option lists CPU and operating system information for
  113.           the domain.  The --dd option lists all contents of a zone
  114.           transfer.  When output is directed to a file, hash
  115.           marks are printed for every 50 records received from
  116.           the server.
  117.  
  118.  
  119.      vviieeww _f_i_l_e_n_a_m_e
  120.           Sorts and lists the output of previous llss command(s)
  121.           with _m_o_r_e(1).
  122.  
  123.  
  124.      hheellpp
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0              August 17, 1988                        2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NSLOOKUP                  User Commands                  NSLOOKUP
  137.  
  138.  
  139.  
  140.      ??    Prints a brief summary of commands.
  141.  
  142.  
  143.      eexxiitt Exits the program.
  144.  
  145.  
  146.      sseett _k_e_y_w_o_r_d[=_v_a_l_u_e]
  147.           This command is used to change state information that
  148.           affects the lookups.  Valid keywords are:
  149.  
  150.           aallll  Prints the current values of the various options
  151.                to sseett.  Information about the  current default
  152.                server and host is also printed.
  153.  
  154.           [[nnoo]]ddeebbuugg
  155.                Turn debugging mode on. A lot more information is
  156.                printed about the packet sent to the server and
  157.                the resulting answer.
  158.                (Default = nodebug, abbreviation = [no]deb)
  159.  
  160.           [[nnoo]]dd22
  161.                Turn exhaustive debugging mode on.  Essentially
  162.                all fields of every packet are printed.
  163.                (Default = nod2)
  164.  
  165.           [[nnoo]]ddeeffnnaammee
  166.                Append the default domain name to every lookup.
  167.                (Default = defname, abbreviation = [no]def)
  168.  
  169.           [[nnoo]]sseeaarrcchh
  170.                With defname, search for each name in parent
  171.                domains of the current domain.
  172.                (Default = search)
  173.  
  174.           ddoommaaiinn==_n_a_m_e
  175.                Change the default domain name to _n_a_m_e. The
  176.                default domain name is appended to all lookup
  177.                requests if the ddeeffnnaammee option has been set.  The
  178.                search list is set to parents of the domain with
  179.                at least two components in their names.
  180.                (Default = value in hostname or /etc/resolv.conf,
  181.                abbreviation = do)
  182.  
  183.           qquueerryyttyyppee==_v_a_l_u_e
  184.  
  185.           ttyyppee==_v_a_l_u_e
  186.                Change the type of information returned from a
  187.                query to one of:
  188.  
  189.                A         the host's Internet address (the
  190.                          default).
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0              August 17, 1988                        3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. NSLOOKUP                  User Commands                  NSLOOKUP
  203.  
  204.  
  205.  
  206.                CNAME     the canonical name for an alias.
  207.  
  208.                HINFO     the host CPU and operating system type.
  209.  
  210.                MD        the mail destination.
  211.  
  212.                MX        the mail exchanger.
  213.  
  214.                MG        the mail group member.
  215.  
  216.                MINFO     the mailbox or mail list information.
  217.  
  218.                MR        the mail rename domain name.
  219.  
  220.                NS        nameserver for the named zone.
  221.           Other types specified in the RFC-1035 document are
  222.           valid but aren't very useful.
  223.           (Abbreviation = q)
  224.  
  225.           [[nnoo]]rreeccuurrssee
  226.                Tell the name server to query other servers if it
  227.                does not have the information.
  228.                (Default = recurse, abbreviation = [no]rec)
  229.  
  230.           rreettrryy==_n_u_m_b_e_r
  231.                Set the number of retries to _n_u_m_b_e_r. When a reply
  232.                to a request is not received within a certain
  233.                amount of time (changed with sseett ttiimmeeoouutt), the
  234.                request is resent. The retry value controls how
  235.                many times a request is resent before giving up.
  236.                (Default = 2, abbreviation = ret)
  237.  
  238.           rroooott==_h_o_s_t
  239.                Change the name of the root server to _h_o_s_t. This
  240.                affects the rroooott command.
  241.                (Default = sri-nic.arpa, abbreviation = ro)
  242.  
  243.           ttiimmeeoouutt==_n_u_m_b_e_r
  244.                Change the time-out interval for waiting for a
  245.                reply to _n_u_m_b_e_r seconds.
  246.                (Default = 10 seconds, abbreviation = t)
  247.  
  248.           [[nnoo]]vvcc
  249.                Always use a virtual circuit when sending requests
  250.                to the server.
  251.                (Default = novc, abbreviation = [no]v)
  252.  
  253. DDIIAAGGNNOOSSTTIICCSS
  254.      If the lookup request was not successful, an error message
  255.      is printed.  Possible errors are:
  256.  
  257.      Time-out
  258.  
  259.  
  260.  
  261. Sprite v1.0              August 17, 1988                        4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. NSLOOKUP                  User Commands                  NSLOOKUP
  269.  
  270.  
  271.  
  272.           The server did not respond to a request after a certain
  273.           amount of time (changed with sseett ttiimmeeoouutt==_v_a_l_u_e) and a
  274.           certain number of retries (changed with sseett
  275.           rreettrryy==_v_a_l_u_e).
  276.  
  277.      No information
  278.           Depending on the query type set with the sseett qquueerryyttyyppee
  279.           command, no information about the host was available,
  280.           though the host name is valid.
  281.  
  282.      Non-existent domain
  283.           The host or domain name does not exist.
  284.  
  285.      Connection refused
  286.      Network is unreachable
  287.           The connection to the name or finger server could not
  288.           be made at the current time.  This error commonly
  289.           occurs with ffiinnggeerr requests.
  290.  
  291.      Server failure
  292.           The name server found an internal inconsistency in its
  293.           database and could not return a valid answer.
  294.  
  295.      Refused
  296.           The name server refused to service the request.
  297.  
  298.  
  299.      The following error should not occur and it indicates a bug
  300.      in the program.
  301.  
  302.      Format error
  303.           The name server found that the request packet was not
  304.           in the proper format.
  305.  
  306.  
  307. FFIILLEESS
  308.      /etc/resolv.conf    initial domain name and name server
  309.      addresses.
  310.      /usr/local/nslookup.help summary of commands.
  311.  
  312. SSEEEE AALLSSOO
  313.      resolver(3), resolver(5), named(8),
  314.      RFC-1034  ``Domain Names - Concepts and Facilities''
  315.      RFC-1035  ``Domain Names - Implementation and Specifica-
  316.      tion''
  317.  
  318. AAUUTTHHOORR
  319.      Andrew Cherenson
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Sprite v1.0              August 17, 1988                        5
  328.  
  329.  
  330.  
  331.